配置组与另类写法示例

ver.20210818（此为过时旧版，前往首页查看新版）

序

阅读本章前默认已基本熟悉 mpv.conf 内各参数用途及含义
mpv.com 文件是MPV播放器的CLI（命令行界面）程序
这里有另一种思路下 mpv.conf 的写法与更多条件配置示例(conditional auto profiles)

☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲

起

mpv.conf 里的参数分为通用参数和配置参数。通用参数在你打开MPV空窗口的同时就已经加载了，而配置参数正常情况下不会加载。你所见到的 [xxxxx] 这样的文本就是一个配置参数的头部标志，在首个未被注释掉的配置 [xxxxx] 所在行之前的参数都是通用参数，在两个配置 [profile-x] 和 [profile-y] 所在行之间的参数都属于 [profile-x] ，这些特性也决定了通用参数只能写在最前面。

配置参数又分为常规配置和条件配置。先讲解一下常规配置，它不会自动触发，下面导入实际例子。

基本操作

很多人的 mpv.conf 里都有一条高频的通用参数 --profile=gpu-hq ，它其实就是一套预设参数组的集合。MPV其实预设了不止一套参数组，你可以通过在 mpv.com 文件所在目录打开 PowerShell （空白处按住Shift+单机鼠标右键）执行 ./mpv --profile=help 得到所有可用的（常规+条件）配置：


xxxxxxxxxx
12
1
#上图例为懒人包v20210210的所有可用配置，代码块展示的是0.33原版的
2
PS C:\MPV list\mpv-stable> ./mpv --profile=help
3
Available profiles:
4
        opengl-hq
5
        sw-fast
6
        low-latency
7
        gpu-hq
8
        encoding
9
        libmpv
10
        builtin-pseudo-gui
11
        pseudo-gui
12
        default

同样的位置， PowerShell 执行 ./mpv --show-profile=配置名 查看某个配置的实际内容：


xxxxxxxxxx
10
1
PS C:\MPV list\mpv-stable> ./mpv --show-profile=gpu-hq
2
Profile gpu-hq:
3
 scale=spline36
4
 cscale=spline36
5
 dscale=mitchell
6
 dither-depth=auto
7
 correct-downscaling=yes
8
 linear-downscaling=yes
9
 sigmoid-upscaling=yes
10
 deband=yes

所以你在 mpv.conf 中某行写入 --profile=gpu-hq 时实际等效在该位置按顺序写入以上八项实际参数。

顺序逻辑

① 通用参数：执行逻辑是从上到下依次读取。假如你想在 mpv.conf 中启用 --profile=gpu-hq 的同时关闭 --deband ，却这样写：


xxxxxxxxxx
2
1
deband=no
2
profile=gpu-hq

只会得到相反的结果：MPV先关闭了去色带，再读取 [gpu-hq] 后又打开了去色带功能。正确写法是调换这两行参数的位置。（当然你也可以再往后额外加一行 --deband=no ，但是正常人应该不会这么做）

② 配置参数：虽然，实际运行时条件配置的先后触发顺序文档中没有记录（根据观察是相对固定的），但是，常规配置和条件配置参数在 mpv.conf 中没有书写顺序的要求。

创造检验运用

建议用无脚本和插件的MPV做测试 https://sourceforge.net/projects/mpv-player-windows/files/64bit/
创建自己的配置名称不要与已有的重名（我没有测试过后果）
在了解基本逻辑之后可以进行创建自己的配置参数

① 先从常规配置起步尝试在空白的 mpv.conf 中创造一个简单的常规配置：


xxxxxxxxxx
6
1
[JBLp]                      # 配置名。支持中文
2
profile-desc=叽叽哔哔循环     # [多余参数] 配置描述，支持中文，随意填写
3
video-sync=audio            # 自定义参数1
4
loop-file=inf               # 自定义参数2
5
audio-pitch-correction=no   # 自定义参数3
6
speed=2                     # ......

保存之后退出，检验：法(1) 打开MPV空窗口，`键调出控制台（控制台模式下屏蔽绝大多数快捷键，按Esc关闭）

输入 apply-profile JBLp 执行（回车键）。正常情况是控制台不会有信息显示，此时一次性拖入任意数量的视频，符合预期的表现是当前文件二倍速播放+音调变高+无限单曲循环。

法(2) mpv.conf 内最上方加入通用参数 --profile=JBLp ，即整体修改成如下样式。


xxxxxxxxxx
4
1
profile=JBLp
2

3
[JBLp]
4
###以下内容省略

之后打开MPV空窗口，一次性拖入任意数量的视频，检查实际表现。

▲ 当然，此时你也可以通过前面的基本操作，可以发现 PowerShell 执行对应命令产生的列表中出现了自己刚写的这个配置 JBLp 。如果你填写了 --profile-desc=<value> ，那么这项值也会显示（见最上方图）

② 进阶尝试一个典型的条件配置在之前的 mpv.conf 中继续修改，以很常见的需求——1080p的视频制定单独方案来举例：


xxxxxxxxxx
12
1
#profile=JBLp # 现在不需要它捣乱
2

3
[JBLp]
4
###以下内容省略
5

6
[1080p]                                   # （同前）
7
profile-desc=全高清方案                     # （同前）
8
profile-cond=height==1080 and width==1920 # [必要参数] 用于判定满足该条件时自动执行该套参数组
9
profile-restore=copy                      # [选用参数] 备份执行该配置前的所有参数，用于恢复
10
cscale=jinc
11
scale=jinc
12
dscale=jinc

保存之后退出，按设定的条件进行检验：先打开MPV空窗口，调出控制台， --profile-cond 的值如果有书写错误会有类似 [auto_profiles] Profile '1080p' condition: 的红色文本报错信息，无错再进行下一步。一次性拖入1080p和720p的两个视频，当播放1080p视频时控制台自动弹出文本 [auto_profiles] Applying auto profile: 1080p ，当切换到720p视频时控制台显示 [auto_profiles] Restoring profile: 1080p 你也可以同时查看内置的 stats.lua 统计信息(Shift+i)的第二页共同检验jinc算法的切换是否正常。

▲ 不写或注释掉选用参数 #profile-restore=copy 后，MPV在满足该配置的触发条件后彻底覆盖原参数。该行为类似于自动在控制台输入 apply-profile 1080p

▲ --profile-cond 可以用通用参数作为判定条件，也可以用 https://mpv.io/manual/master/#property-list 里的属性。这些属性需要用引号和中括号规范，单等于号不可用， and or not 分别表示 和或非 ，详细示例见后文。

☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲☲

后

可能的风险

条件配置的最大局限在于，它并不是直接的开关on/off的关系，自动触发某条件配置后，你在这期间手动激活的其它参数，有可能会随着撤回该条件配置的同时一起被移除，可以通过以下的示例轻松复现问题：

新建空白 input.conf 中写入：


xxxxxxxxxx
1
1
CTRL+v vf add deblock=filter=weak:block=4 # 去色块滤镜

清空 mpv.conf 中写入：


xxxxxxxxxx
5
1
[N-fs-r]
2
 profile-desc=非全屏状态时画面顺时针转90°
3
 profile-cond=not fullscreen
4
 profile-restore=copy
5
 vf-add=rotate=90*PI/180

然后打开MPV空窗口，拖入一个视频，已触发条件配置 N-fs-r ，再手动 Ctrl+v 激活去色块滤镜，观察统计信息的滤镜列表：进入全屏，假想情况是只撤销 rotate 旋转滤镜，实际是所有视频滤镜都消失了

存在的一个不完美的解决方案是改为非典型条件配置并创建对应的反配置：


xxxxxxxxxx
10
1
[N-fs-r]
2
 profile-desc=非全屏状态时画面顺时针转90°
3
 profile-cond=not fullscreen
4
#profile-restore=copy                 # 注释/删掉回归默认值 default
5
 vf-add=rotate=90*PI/180
6

7
[N-fs-r_Alt]                          # 反配置没有名称格式要求，随意写
8
 profile-desc=N-fs-r的反配置
9
 profile-cond=fullscreen              # not “非”的对应
10
 vf-remove=rotate=90*PI/180           # 改为 --vf-add 的对应行为参数

再次检验，实际情况符合预期。

配置规范化

通用参数和常规配置可以设计的很复杂，但条件配置应尽量简化以避免实际运行时可能造成的混乱。在MPV更改目前这个条件配置的机制之前，只有通过相对规范的配置来避免切换中可能存在的问题。虽然配置可以相互套娃，但是最好不要这么做。

一个简单合理的 mpv.conf 示范：


xxxxxxxxxx
41
1
profile=gpu-hq
2

3
[SD]
4
profile-restore=copy
5
profile-cond=width==720 and (height==576 or height==480)
6
scale=ewa_lanczossharp
7
cscale=bilinear
8
dscale=ewa_lanczos
9
linear-downscaling=yes
10
deband=yes
11
glsl-shaders="~~/shaders/KrigBilateral.glsl;~~/shaders/ravu-zoom-r4.glsl"
12

13
[HD]
14
profile-restore=copy
15
profile-cond=width==1280 and width==720
16
scale=ewa_lanczossharp
17
cscale=bilinear
18
dscale=ewa_lanczos
19
linear-downscaling=yes
20
deband=yes
21
glsl-shaders="~~/shaders/KrigBilateral.glsl;~~/shaders/FSRCNNX_x2_16-0-4-1.glsl"
22

23
[FHD&2K]
24
profile-restore=copy
25
profile-cond=(width==1920 or width==2560) and (height==1080 or height==1440)
26
scale=spline16
27
cscale=spline64
28
dscale=catmull_rom
29
linear-downscaling=yes
30
deband=yes
31
glsl-shaders="~~/shaders/Anime4K_Upscale_CNN_L_x2.glsl"
32

33
[UHD]
34
profile-restore=copy
35
profile-cond=width>=3840 or height>=2160
36
scale=bilinear
37
cscale=bilinear
38
dscale=mitchell
39
linear-downscaling=no
40
deband=no
41
glsl-shaders="~~/shaders/SSimDownscaler.glsl"

现实情况中设置多重且复杂的条件配置会导致一个播放视频同时调用多个配置，切换下一个视频时只撤销部分配置又拉起新的配置，暂无验证是否在这种情况下产生异常情况，因此示范偏保守只选择分辨率作为变量设置不同组。

mpv.conf 的特殊技巧

以下是一份完整的非一般的 mpv.conf 写法，同时运用了上文所叙述的内容。将所有参数组合配置化(profile)，通用区只用单一类参数 --profile=<value> 进行自由灵活搭配，通过组合调用后实际构成一套完整的通用参数。条件配置主要的是提供范例便于萌新依葫芦画瓢，和其上方的参数一起使用可能存在逻辑上的bug（写的时候没有考虑实际使用）

⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘⇘ mpv.conf ⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙⇙

##== 通用参数区 ==##


xxxxxxxxxx
14
1
#profile=profile-1,profile-2,profile-3
2
##这是 --profile=<value> 的官方推荐写法，执行顺序从左到右，但不易读和修改，因此换用下面的写法，执行顺序从上到下
3

4
profile=Base-1
5
profile=A-2
6
profile=V-0
7
#profile=Icc-1
8
#profile=Deband-1
9
profile=Smooth-2
10
profile=Sub-2
11
profile=Screenshot-3
12

13
#profile=BenchMark # 此配置应单独使用
14
#log-file="~~desktop/mpv-test.log"

##== 常规配置区 ==##


xxxxxxxxxx
147
1
#[示例常规配置]         # 配置名。支持中文
2
#profile-desc=这是举例 # [多余]配置描述，支持中文，随意填写
3
#                     # 自定义参数1
4
#                     # 自定义参数2
5
#                     # ......
6

7
[Base-1]
8
vo=gpu
9
gpu-api=d3d11
10
hwdec=d3d11va-copy
11
hidpi-window-scale=no
12
keep-open=yes
13
hr-seek-framedrop=no
14
save-position-on-quit=no
15
gpu-shader-cache-dir="~~/shaders_cache"
16

17
[Base-2]
18
vo=gpu
19
gpu-api=vulkan
20
hwdec=no
21
keep-open=yes
22

23
[A-1]
24
audio-file-auto=fuzzy
25
volume-max=100
26
audio-pitch-correction=yes
27
af=scaletempo2
28

29
[A-2]
30
audio-file-auto=fuzzy
31
volume-max=130
32
audio-pitch-correction=yes
33
af=rubberband
34

35
[V-0]
36
scale=bilinear
37
cscale=bilinear
38
dscale=bilinear
39

40
[V-1]
41
scale=ewa_lanczossharp
42
cscale=spline36
43
dscale=mitchell
44
dither-depth=auto
45
correct-downscaling
46
linear-downscaling
47
sigmoid-upscaling
48

49
[V-2]
50
glsl-shaders="~~/shaders/ravu-zoom-r4-chroma.glsl;~~/shaders/ravu-zoom-r4.glsl"
51

52
[Icc-0]
53
target-prim=dci-p3
54
target-trc=gamma2.2
55

56
[Icc-1]
57
icc-profile-auto
58
#icc-3dlut-size=256x256x256
59
icc-cache-dir="~~/icc_cache"
60
#vf=format:gamma=gamma2.2
61

62
[Deband-1]
63
deband
64
deband-iterations=2
65
deband-threshold=32
66
deband-range=14
67
deband-grain=12
68

69
[Smooth-1]
70
video-sync=display-resample
71
video-sync-max-video-change=5
72
interpolation
73
tscale=oversample
74

75
[Smooth-2]
76
video-sync=display-resample
77
video-sync-max-video-change=5
78
interpolation
79
tscale=box
80
tscale-window=sphinx
81
tscale-radius=1.01
82
tscale-clamp=0.0
83

84
[Sub-1]
85
sub-auto=fuzzy
86
slang=chs,sc,zh,chi,zho
87
blend-subtitles=video
88
sub-use-margins=no
89
sub-font='YouYuan'
90

91
[Sub-2]
92
sub-auto=fuzzy
93
slang=chs,sc,zh,chi,zho
94
sub-ass-force-margins=yes
95
sub-font='YouYuan'
96

97
[Screenshot-1]
98
screenshot-format=jpg
99
screenshot-jpeg-quality=100
100
#screenshot-jpeg-source-chroma=yes
101
screenshot-tag-colorspace=yes
102
#screenshot-high-bit-depth=yes
103
screenshot-template=MPV-%P-N%n
104
screenshot-directory=~~desktop/
105

106
[Screenshot-2]
107
screenshot-format=png
108
screenshot-png-compression=5
109
#screenshot-png-filter=5
110
screenshot-tag-colorspace=yes
111
#screenshot-high-bit-depth=yes
112
screenshot-template=MPV-%P-N%n
113
screenshot-directory=~~desktop/
114

115
[Screenshot-3]
116
screenshot-format=webp
117
screenshot-webp-lossless=yes
118
#screenshot-webp-quality=100
119
screenshot-webp-compression=3
120
screenshot-tag-colorspace=yes
121
#screenshot-high-bit-depth=yes
122
screenshot-template=MPV-%P-N%n
123
screenshot-directory=~~desktop/
124

125

126
[BenchMark]
127
##此配置应单独使用
128
window-scale=0.5
129
#vo=gpu
130
#gpu-api=vulkan
131
#hwdec=d3d11va
132
sub=no
133
audio=no
134
#untimed=yes
135
keep-open=always
136
video-sync=display-desync
137
interpolation=no
138
vulkan-swap-mode=immediate
139
opengl-swapinterval=0
140
d3d11-sync-interval=0
141
osd-msg1="FPS: ${estimated-display-fps}"
142
scale=jinc
143
cscale=jinc
144
dscale=jinc
145
vf=""
146
glsl-shaders=""
147
log-file="~~desktop/mpv-BenchMark.log"

##== 条件配置区 ==##

##下方的可交叉条件显然涉及前文提到的风险，但是重点是列举一些例子以供萌新依葫芦画瓢。


xxxxxxxxxx
70
1
#[示例条件配置]         # 配置名。支持中文
2
#profile-desc=这是举例 # [多余] 配置描述，支持中文，随意填写
3
#profile-restore=copy # [可选] 此参数一般用于回归触发前的通用参数（关闭此项将保留该配置参数并覆盖通用参数）
4
#profile-cond=???     # [必要] 触发该配置的条件。可用的属性列表：https://mpv.io/manual/master/#property-list
5
#                     # 自定义参数1
6
#                     # 自定义参数2
7
#                     # ......
8

9
[N-fs-p]
10
profile-desc=切换到非全屏状态时暂停
11
profile-restore=copy
12
profile-cond=not fullscreen
13
pause
14

15
[Short-loop]
16
profile-desc=短时长文件自动循环播放
17
profile-restore=copy
18
profile-cond=duration<=150
19
loop-file=inf
20

21
[Deband-0]
22
profile-desc=YUV420P10及以上的源关闭去色带
23
profile-restore=copy
24
profile-cond=p["video-params/average-bpp"]>=24
25
deband=no
26

27
[HDR2SDR]
28
profile-desc=高转标准动态范围
29
profile-restore=copy
30
profile-cond=p["video-params/primaries"]=="bt.2020"
31
blend-subtitles=no
32
#tone-mapping=bt.2390
33
hdr-compute-peak=yes
34
cscale=bilinear
35
scale=bilinear
36
dscale=bilinear
37
deband=no
38
vf=""
39
glsl-shaders=""
40

41
[SD-ex]
42
profile-desc=低清源增强
43
profile-restore=copy
44
profile-cond=height<720 and width<1280
45
deband
46
deband-iterations=3
47
deband-threshold=48
48
deband-range=12
49
deband-grain=0
50
glsl-shaders="~~/shaders/KrigBilateral.glsl;~~/shaders/noise_static_chroma.glsl;~~/shaders/noise_static_luma.glsl;~~/shaders/nnedi3-nns64-win8x4.glsl"
51

52
[HD++]
53
profile-desc=高清源选项
54
profile-restore=copy
55
profile-cond=(height>=720 or height<1080) and (width>=1280 or width<1920)
56
cscale=sinc
57
cscale-window=blackman
58
cscale-radius=3
59
glsl-shaders="~~/shaders/FSRCNNX_x2_8-0-4-1.glsl"
60

61
[2K++]
62
profile-desc=超清源选项
63
profile-restore=copy
64
profile-cond=height>1440 and width>2560
65
cscale=catmull_rom
66
scale=spline36
67
dscale=mitchell
68
linear-downscaling=no
69
glsl-shaders="~~/shaders/SSimDownscaler.glsl"
70
deband=no

⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗⇗ mpv.conf ⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖⇖

参数分离

相比上方的野路子，这个操作很正经。（这也是20210617之后的懒人包版本所采用的方案） mpv.conf 中的任意位置皆可，写入 include = "~~/xxxxx.conf" 然后mpv.conf的同目录建立这个同名文件

该参数用于在主设置文件后追加读取的设置文件，这样主设置文件只写通用参数，追加的只写配置组。